home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_100 / 114_01 / install.doc < prev    next >
Text File  |  1987-07-13  |  8KB  |  232 lines
  1. .cm screen editor:  installation guide
  2. .cm Source:  install.doc
  3. .cm
  4. .he 'install.doc''September 6, 1981'
  5. .fo ''-#-''
  6.  
  7.    This document tells you how to get the
  8. screen editor up and running on your system.
  9. To do this you need the following:
  10.  
  11. .nf
  12. 1.  A CP/M version 1.4 or 2.2 operation system which
  13.     runs on an 8080, Z-80 or 8085 based computer.
  14.  
  15. 2.  An 8 inch single density floppy disk drive.
  16.  
  17. 3.  At least 48K of central memory.
  18.  
  19. 4.  A video display which has a goto x,y cursor
  20.     positioning function.
  21. .br
  22. .fi
  23.  
  24.    To get the screen editor up and running on your
  25. system all you need to do is follow these 5 steps.
  26.  
  27. .ul
  28. Step 1:  Back up the diskette.
  29.  
  30.    Make a backup copy of your diskette.
  31. Do it now.
  32.  
  33. .ul
  34. Step 2:  Run the configuration program
  35.  
  36.    Start the configuration program by typing 'config'
  37. from CP/M.
  38.  
  39.    The configuration program tailors the screen editor for
  40. your particular keyboard and display screen.
  41. The configuration program asks you three sets of questions.
  42. After you finish answering all the questions the configuration
  43. progrm creates two files which describe your keyboard
  44. and video display.
  45. These two files are included into the screen editor during
  46. step 3.
  47.  
  48.    The first set of questions ask you what keyboard
  49. keys you want to use for each special function that
  50. the editor uses.
  51. To answer each question you may type either a decimal
  52. number or a carriage return.
  53.  
  54.    If you type a carriage return the configuration
  55. program will use the default key.
  56. The configuration program will tell you what the
  57. default value is for each key.
  58. I recommend that you use the default value
  59. unless your keyboard does not have the default key.
  60.  
  61.    If you type a decimal number instead of a carriage
  62. return then you are indicating that you wish to
  63. use the key whose ascii code is the same as that
  64. decimal number.
  65. For example, suppose the configuration program
  66. asks you for the value of the left key.
  67. If you type (say) 11 as a response this means
  68. that the control-k key will be used as the left key.
  69.  
  70.    Note that the values you enter should either
  71. be less than 32 or be equal to 127.
  72. Avoid values greater than 127 or less than 0.
  73.  
  74.    After you answer all these questions you
  75. will be asked if all the answers are correct.
  76. If you say no, then you will be asked the same
  77. questions over again.
  78.  
  79.    Note that you can always use the normal
  80. CP/M line editing functions if you make
  81. a mistake in typing a line.
  82. Also, you can leave the configuration program
  83. by hitting control-c any time that the program
  84. asks for input from you.
  85.  
  86.    The next set of questions asks what special
  87. built-in functions your display screen has.
  88. Answer each question with a yes or a no.
  89. You may use the letters 'y' or 'n' for yes or no.
  90.  
  91.    Again, after finishing the questions you will
  92. be asked if you are satisfied with your answers.
  93. If not, type 'no' and you will be given another chance.
  94.  
  95.    The third and last set of questions asks you
  96. to supply the actual characters that you must
  97. output to your display screen to get the screen
  98. to do the special functions you said it had.
  99. For each special functions, you will be asked to
  100. enter those bytes one at a time.
  101.  
  102.    For example, let us start with the goto x,y
  103. special function.
  104. This is the only special function that your
  105. display MUST have in order to use the screen editor.
  106. Now suppose that in order to move the cursor to
  107. ROW y and COLUMN x you must output the escape
  108. character (27) followed by an equal sign, followed
  109. by the 32 plus x, followed by 32 plus y.
  110. To do this you would type the following:
  111.  
  112. .nf
  113. Enter byte 1:  27
  114. Enter byte 2:  '='
  115. Enter byte 3:  x+32
  116. Enter byte 4:  y+32
  117. Enter byte 5:  (return)
  118. .br
  119. .fi
  120.  
  121.    Note that you type a carriage return to stop entering
  122. bytes.
  123.  
  124.    Be
  125. .ul
  126. sure
  127. that you enter the row and column numbers in the order that
  128. your terminal expects.
  129. (Many terminals use a sequence in which the row and column
  130. numbers are reversed from the sequence shown above).
  131.  
  132.    If you do make a mistake in the goto xy sequence
  133. then the screen will not look at
  134. all like it should
  135. when you run the editor in step 5.
  136.  
  137.    When you have finished with this last section
  138. you will be asked whether you are ready to
  139. create two files.
  140. If you say yes and the configuration program will
  141. erase the two files if they already exist,
  142. create the two files, and then exit.
  143. If you say no the configuration program will exit without
  144. doing anything.
  145. Say yes unless you don't want to erase existing versions
  146. of the two files.
  147.  
  148. .ul
  149. Step 3:  Compile the editor
  150.  
  151.    Next, compile the editor using the BDS C compiler.
  152. Either version 1.43 or 1.44 will work.
  153. You will need to compile ed2.bds through ed10.bds,
  154. including ed6.ccc.
  155. The submit file edcomp.sub will do it all at once.
  156.  
  157.    If you get an error you may have made a mistake
  158. when you typed in the sequences of bytes for the
  159. configuration program.
  160. Such an error will show up when the compiler is compiling
  161. the file ed6.ccc.
  162. If there is an error on file ed6.ccc you must redo step 2.
  163.  
  164.    Something is wrong with the files on your
  165. disk if you got any other error.
  166. No error you can make using the configuration
  167. program should cause an error which shows up in any
  168. file except ed6.ccc.
  169. Get a fresh copy of the disk from your backup
  170. diskette and start over again from step 2.
  171.  
  172. .ul
  173. Step 4:  Link the editor
  174.  
  175.    Use the BDS C clink program to create ed2.com.
  176. The file edlink.sub shows how to call the linker.
  177.  
  178. .ul
  179. Step 5:  Test and use the editor
  180.  
  181.    You are now ready to use the editor.
  182. Invoke the editor by typing 'ed2' from CP/M.
  183. It should clear the screen, draw the prompt line at the
  184. top of the screen and tell you what version you are using.
  185.  
  186.    If that doesn't happen you probably gave the configuration
  187. program the wrong information about the goto x,y cursor
  188. function.
  189. When you specify the goto xy function remember:
  190. x means the COLUMN number, y means the ROW number.
  191. Make
  192. .ul
  193. sure
  194. you have specified the row and column numbers in the order your
  195. terminal expects.
  196. Take a deep breath and repeat steps two through six.
  197.  
  198.    If the screen looks reasonable, try out all the commands
  199. from the user guide.
  200. Be sure to check whether the hardware screen scrolling
  201. is working properly.
  202.  
  203.    Note that the configuration program can not handle keyboard
  204. keys that produce more than one character.
  205. If you want to use such keys you will have to modify the file
  206. ed2.bds.
  207. Then, of course, you will have to recompile and link
  208. the new editor.
  209. I recommend that you get the editor working before you attempt
  210. to modify it.
  211.  
  212. NOVICES GUIDE TO COMPILING AND LINKING
  213. .nf
  214.  - only if you are using CP/M version 1.4, use ED or
  215.    some other editor to comment out the version 2.2
  216.    syscstat(), syscin() and syscout() routines in
  217.    ED8.BDS and uncomment the equivalent version 1.4 routines
  218.  - copy the editor source files and the submit files to    
  219.    an empty disk (PIP A:=B:ED*.* will do it).
  220.    add a copy of BDSCIO.H, the compiler (CC?.COM), linker
  221.    (CLINK.COM), runtime package (C.CCC), library (DEFF?.CRL)
  222.    and finally SUBMIT.COM.
  223.  - boot the system with this disk in drive A and type
  224.    submit edcomp.
  225.  - get a cup of coffee.
  226.  - if all is well, type submit edlink and finish your
  227.    coffee
  228.  - the resulting editor will be called ed2.com
  229.  
  230.    good luck!
  231.  
  232.